home *** CD-ROM | disk | FTP | other *** search
/ Magnum One / Magnum One (Mid-American Digital) (Disc Manufacturing).iso / d26 / dlanet.arc / DLANET.DOC next >
Encoding:
Text File  |  1990-05-21  |  9.6 KB  |  197 lines
  1.               DLANET - Polynomial and Circuit Analysis Program
  2.  
  3.               Version 1.0, April 1987
  4.  
  5.               Copyright - C - 1987, L. P. Huelsman, All rights
  6.                                    resrved.
  7.  
  8.               The required input-output file format for the turbopascal 
  9.               version of the DLANET program follows.  Note: Use Capital
  10.               letters as indicated.
  11.  
  12.           Line#   Function             Comments
  13.  
  14.             1     Title           up to 10 ASCII characters.
  15.             2     POL or CIR      POL for polynomial analysis.
  16.                                   CIR for network analysis.
  17.             3     RAD or HZ       RAD for a frequency in Radians per seconds.
  18.                                   HZ for a frequency in Hertz.
  19.             4     LIN or LOG      LIN for a linear frequency scale.
  20.                                   LOG for a logarithmic frequency scale.
  21.             5     FRQ xxx yyy     Frequency range where
  22.                                      xxx is the lower frequency.
  23.                                      yyy is the upper frequency.
  24.  
  25.             6     MAG yyy scal    Ordinate range for the magnitude plot.
  26.                                      yyy is the upper ordinate value.
  27.                                      the lower ordinate value is yyy-90.
  28.                                      scal is a multiplicative constant.
  29.                                   option: if yyy = 999, the scaling is 
  30.                                      automatic.
  31.  
  32.             7     NDB or DB       DB for a decibel ordinate scale for MAG.
  33.                                   NDB for a non-dB (linear) scale for MAG.
  34.  
  35.             8     PHS yyy scal    Ordinate range for the phase on the plot.
  36.                                      yyy is the upper ordinate value.
  37.                                      the lower ordinate value is yyy-90.
  38.                                      scal is a multiplicative constant.
  39.                                   option: if yyy = 999, the scaling is 
  40.                                      automatic.
  41.  
  42.             9     PLT or PRT      PLT for a plot on the screen.
  43.                                   PRT for both a plot and a file writing.
  44.  
  45.      IF Polynomial Analysis:
  46.             10    m  n  H0         Numerator degree, Denominator degree,
  47.                                    Multiplicative constant.
  48.             11 to (11+m)           Coefficients of the numerator.
  49.             (11+m+1) to (11+m+n+1) Coefficients of the denominator.
  50.             (11+m+n+2)    END      End command.
  51.  
  52.      IF Circuit Analysis:
  53.             10 to whatever...
  54.                   Rn xx yy zz     Resistor number n connected from
  55.                                     node xx to node yy with value zz.
  56.                   Cn xx yy zz     Capacitor number n connected from
  57.                                     node xx to node yy with value zz.
  58.                   Ln xx yy zz     Inductor number n connected from
  59.                                     node xx to node yy with value zz.
  60.                   Vn xx yy zz     VCVS number n with input node xx,
  61.                                     output node yy, and gain zz.
  62.                   Dn xx yy zz tt  DVVS number n with positive input
  63.                                     node xx, neg inp node yy, to
  64.                                     output node zz with gain tt.
  65.                   On xx yy zz     Op Amp number n with positive input
  66.                                     node xx, neg inp node yy, and
  67.                                     output node zz.
  68.             Last Line   END       To mark the end of the file.
  69.  
  70.              Comments:  After  each  command  or  entry  followed
  71.              by  a  blank character,  the  remainder of the line
  72.              can be filled up with any ASCII text which is ignored
  73.              when the file is read by DLANET.
  74.  
  75.  
  76.            The DLANET error messages and suggestions to avoid these mistakes.
  77.  
  78.                Some  of these  errors are obvious mistakes from the user when
  79.         connecting active elements. They may be short circuits,  operation in
  80.         saturation  modes,  or  nonsenses.  Other  errors  occur  because  of
  81.         constraints in the algorithm for the reduction of the matrix. In that
  82.         case,  the user  has to  rearrange  the circuit so that the reduction
  83.         algorithm is actually working. In the next section are a few hints
  84.         to have the constraints satisfied.
  85.  
  86.          User related error messages:
  87.              
  88.                 Error # 1 : A node number is negative.
  89.        
  90.                 Error # 2 :  A node number is too large for an active element.  
  91.                             For the active elements, the node numbers can't be 
  92.                             larger  than  the  largest  node  number  for  the 
  93.                             passive circuit.  
  94.  
  95.                 Error # 3 :  Output  of the  active element either grounded or 
  96.                             connected to the input. Implies a short circuit.  
  97.                             
  98.                 Error # 4 : Two ideal source outputs tied together. Short Ckt.
  99.                             
  100.                 Error # 5 : Zero gain of a VCVS or DVVS. Nonsense.
  101.                             
  102.                 Error # 6 : Input of a VCVS grounded. Nonsense.
  103.                             
  104.                 Error # 7 : Zero differential voltage for a DVVS or Op Amp.
  105.                             
  106.                 Error # 8 : Input connected to own output on VCVS. Short Ckt.
  107.  
  108.                 Error # 9 : Direct feedback on DVVS or Op Amp. Unstable.
  109.                             
  110.                 Error #10 : Direct relation between the network input and its 
  111.                             output.  Nonsense.  
  112.  
  113.          Algorithm related error messages:
  114.                             
  115.                 Error #11 :  A specific element can not  be reduced. Its nodes 
  116.                             either can't  be  deleted  or  have  already  been 
  117.                             deleted by other elements.  
  118.  
  119.                 Error #12 : A specific element could be reduced with some extra
  120.                             added components.  See the hints in  Appendix C.  
  121.                             
  122.                 Error #13 :  The  output  of  an  active  element  can  not be 
  123.                             connected to the highest node number.  This  is  a 
  124.                             constraint from the matrix inversion algorithm.  
  125.  
  126.  
  127.  
  128.        Some very useful hints when the user is not used to the DLANET program:
  129.  
  130.  
  131.             To avoid an unnecessary waste of user time, here are some
  132.         hints and further explanations to help him:
  133.        
  134.        
  135.              From  DOS,  before  running the DLANET.COM file,  it would be a 
  136.         very good idea to run the GRAPHICS.COM  command  in  case  the  user 
  137.         wants later to print on his printer the high resolution plots.
  138.  
  139.               
  140.              From DLANET,  when a memory file is ready to be analysed, it is 
  141.         better to save it to disk under a dummy name,  so that if there is a 
  142.         fatal  error,  all  the  editing  procedure does not have to be done 
  143.         again.  A simple disk load is enough.
  144.  
  145.  
  146.              It  is much faster to edit a disk input file in compliance with
  147.         the format described in appendix A using an external editor or  word
  148.         processor,  and to use the menudriven editor for small changes only,
  149.         rather than using this specialised editor for editing  a  whole  new
  150.         file from inside the program.
  151.  
  152.  
  153.              For the multiplot option, the best and fastest procedure, is to
  154.         have all the plots ready,  either on a file,  or from the menudriven
  155.         editor. The procedure is to clear the plot memory, set the option to
  156.         store  all  the  coming plots, and run all of them one by one, up to
  157.         five of them. A screen dump to the printer can be done at any time.
  158.  
  159.  
  160.              The node assignment for a passive circuit is straight forward
  161.         and  rather  uncritical.  The  only  requirements are that the input 
  162.         node is 1, the output node is 2, the ground is node 0.  If there are 
  163.         n nodes, they must be numbered from 1 to n, without anyone left.  
  164.        
  165.              With active elements, the user has to know that some nodes will 
  166.         be deleted in the reduction method.  One node  disappears  for  each 
  167.         active element according to a certain procedure.  
  168.              For a VCVS, the computer tries first to delete the output node. 
  169.         If it can't,  the next try is the input node.  For  DVVS,  it  first 
  170.         tries  the output node,  then the positive input node,  and then the 
  171.         negative one.  For the Op Amps,  it tries first the  positive  input 
  172.         node, then the negative one.  
  173.              A  problem  occurs  if  for  any element,  the computer can not 
  174.         delete any of its nodes.  A node can't be deleted if it's either the 
  175.         ground, network input or output nodes, or highest node number.  Also 
  176.         if it has already been deleted by another element.  
  177.              To avoid such problems,  the user  can  simulate  by  hand  the 
  178.         reduction process,  and see whether there are problems,  and if any, 
  179.         either rearrange the network or node numerotation,  or  add  passive 
  180.         elements  in  series  with the infinite impedance input nodes of the 
  181.         concerned elements.  In that last case,  the best way is  to  add  a 
  182.         resistor  which  value  is  matched  with the other resistors of the 
  183.         network.  
  184.         
  185.  
  186.  
  187.  
  188.  
  189.  
  190.  
  191.  
  192.  
  193.  
  194.  
  195.  
  196. 
  197.